package com.naiterui.ehp.bs.wechat.service;

import com.naiterui.ehp.bs.wechat.param.custom.BaseCustomParam;

/**
 * 客服消息api
 *
 * @author zhoupeipei
 * @date 2019-06-18 10:06
 * @since 1.0.0
 */
public interface ICustomMsgApiService {
    /**
     * 以客服消息的形式发送系统消息【文本类型】
     *
     * @param openId
     * @param content <p>格式化好的消息内容,对于超链接或小程序跳转处理示例如下：</p>
     *                <p>超链接：文本内容<a href="http://www.qq.com">点击跳连接</a></p>
     *                <p>小程序：文本内容<a href="http://www.qq.com" data-miniprogram-appid="appid" data-miniprogram-path="pages/index/index">点击跳小程序</a></p>
     */
    void sendSystemMsg(String openId, String content);


    /**
     * 发送客服消息
     *
     * @param customMsgParam
     */
    void sendCustomMsg(BaseCustomParam customMsgParam);

    /**
     * 以客服消息的形式发送系统消息【小程序卡片 】
     *
     * @param openId       普通用户openid
     * @param title        小程序卡片的标题
     * @param appId        小程序appid
     * @param pagePath     小程序的页面路径，跟app.json对齐，支持参数，比如pages/index/index?foo=bar
     * @param thumbMediaId 缩略图/小程序卡片图片的媒体ID，小程序卡片图片建议大小为520*416
     */
    void sendMiniProgramMsg(String openId, String title, String appId, String pagePath, String thumbMediaId);

}
